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OVERVIEW 

Have you ever wislied you could generate some really exciting 
graphic displays with your Atari computer but were discouraged because 
it was too time^consuming to do the really FANCY stuff? Well, wish no 
more!!! With ANIMATOR II you can easily create raoving displays of 
people, objects, monsters from outer space, or just about anything 
your mind can think up. ANIMATOR II lets you create a 'movie # made 
up of frames which you design, one at a time. When you have created 
such a movie, it can be played back at speeds up to 200 frames per 
second. Frames can be saved to disk so that you can impress your 
friends and family at a later date* ANIMATOR II gives you full 
control of your 'movie' characteristics. The frames can be short or 
tall, fat or thin, different colors and different shades, all at 
once!! ANIMATOR II also provides you with lots of time ö saving 
functions so that you can create irapressive displays quickly. 

ANIMATOR II should be of interest to anyone who likes to sit back and 
just have fun with their computer and especially to programmers who 
will be able to really 'spiff up' their prograras witli minimum effort. 


THE IDEA 0F ANIMATION 

The main idea of animation is very simple* The object is to 
create a moving figure* This is accomplished by first creating a 
figure and putting him in the first frame of the movie. Then change 
him a litle bit, perhaps by shifting one leg just a tad# Store this 
in the following frame. Then, move the leg just a little bit further 
and store it in the next frame and so on. After a while you will 
have created a complete sequence for leg movement. To animate this 
figure all you have to do is play the frames one after another at a 
high enough speed and the figure will seem to walk* This is called 

aniraation. The object of this program is to let you create such 
figures with as little effort as possible. Practically all the 
functions of this program are designed to let you make these small 
changes without much work. This way you can spend your time doing 
animation instead of doing all the tedious work that may as well be 
left for the computer. 


MINIMUM RAM AND ACCESSORIES 
Required Accessories 

ATARI BASIC Language Cartridge 
ATARI 810 Disk Drive 
3 2K RAM 

One ATARI Joystick Controller 

One set of ATARI paddle controllers. 

(This program will operate without the paddle controllers but you lose 
the ability to control frame speed when playing a 'mo^ie'.) 

CONTACTING THE AUTHOR 

Due to the fact that this author will be in Argentina until August 
1984, he will not be available for questions about the program until 
he returns. 
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GETTING STARTED 


1. Turn off your computer. 

2. Insert the ATARI BASIC LANGUAGE cartridge into the left hand slot 
of your computer console* 

3. Plug your joystick into port #1. 

4. Plug the paddles into port #2« 

5* Turn on your disk drive. 

6. When the BUSY light goes out, open the disk drive door and insert 
the ANIMATOR II diskette with the label in the lower right^hand corner 
nearest to you. (Use disk drive one if you have more than one drive.) 

7. Turn on your coraputer and your TV set. The program will load into 
meraory and start automatically. (See THE FIRST DISPLAY SCREEN.) 


8. After the program has COMPLETELY loaded into memory you may leave 
the ANIMATOR II disk in the disk drive if you only want to use the 
movies provided with ANIMATOR II. 

9. If you wish to create and save your own movies, please insert a 
FORMATTED disk into the disk drive slot. 

10. If you will probably be doing a lot of design work, it is 
suggested that you label a BLANK W FORMATTED disk for use only with the 
ANIMATOR II program. This way all your movies will be on one disk and 
you won't need to waste your time searching for the disk that has the 
movie that you want. 

11. If this is your first time running the program you should leave 
the ANIMATOR II disk in the disk drive since you will want to play 
with some of the raovies that have been provided with that disk. 
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THE FIRST DISPLAY SCREEN 

The first display screen will come up and it should look like this: 

********************* 


* ANIMATOR II * 

* COPYRIGHT 1983 * 

* BRYAN TALBOT * 

* VERSION 0.0 * 

* * 

* * 

* * 

* * 


********************* 

The disk drive will beep a couple of tiraes and then. 

A MULTI^LIMBED SPACE GIDGER WALKS RIGHT ACROSS THE SCREEN!! 

This is an exaraple of what can be easily accomplished using 
ANIMATOR II. You can keep the GIDGER walking across the screen if you 
hold down the START button. Release the START button to continue on 
with the program. 

The drive beeps a few more times and then you are asked how many 
pixels tall you would like your frames to be. The number '40' is 
flashing on the left side of the screen about halfway down. For raost 
purposes 40 pixels is adequate (this subject will be discussed in more 
detail later) so simply press the button on the joystick to select the 
number of pixels as '40.' 

The screen clears and displays 'loading...' in the center. Please 
wait as the main part of ANIMATOR II is brought into raemory. 

After a few seconds ANIMATOR II will finish loading into memory. At 
this point you may want to follow steps 8 through 10 in GETTING 
STARTED. The screen will look like this: 


At this point you are ready to use ANIMATOR II. 
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DEFINITION OF TERMS 


a) PIXEL „ A PIXEL is the basic building block in ANIMATOR II. 

A PIXEL is just like one square on a sheet of graph paper. 
A square can either be colored in with a pencil or left 
blank* By coloring certain squares on graph paper you can 
draw designs and figures. ANIMATOR II works on this sarae 
principle except that the graph paper is replaced by the 
screen, and instead of coloring it in with a pencil you 
fill it with a spot of light. When a PIXEL is lighted it 
will be referred to as being ON. When it is blank it will 
be called OFF. 

b) LINE A LINE is siraply a horizontal row of PIXELS. 

If you count the nuraber of PIXELS per line on the screen 
(each PIXEL being represented by one dot) you will find 
that each line contains 16 PIXELS. 


c) FRAME s A FRAME is a collection of lines. 

You will notice that there are 24 LINES of PIXELS on the 
screen. This doesn't raean that you are liraited to 24 LINES 
in a FRAME. Rather, you can only see 24 LINES at one time. 
(See explanation of GRAPH.) FRAMES can contain between 24 
and 80 LINES depending on what you selected just after the 
first display screen. Forty LINES per frame is standard. 

d) M0VIE s A M0VIE is a collection of FRAMES• 

The nuraber of FRAMES that you can have in a M0VIE is 
dependent upon the number of LINES that you select for a 
FRAME• If you choose 24 LINES per FRAME you will be able 
to have up to 166 FRAMES per M0VIE. Forty LINES per FRAME 
gives you 100 FRAMES• Eighty LINES gives you 50 FRAMES• 
Other values range between those shown. Each FRAME in a 
M0VIE is assigned a nuraber. With 100 FRAMES the FRAME 
NUMBERS would range frora 0 to 99. 

Just because you CAN have 100 FRAMES in a raovie doesn’t 
raean that you have to use thera all up every time you design 
something. Sorae M0VIES may be only 10 FRAMES long. In 
fact, it is possible to have several different M0VIES 
located in separate sections of raemory at once. For 
instance, you could have one M0VIE occupying FRAMES 0 S 25 
while another occupies FRAMES 30 g 40. 

e) DIRECTORY ŵ A DIRECTORY is a list of all the M0VIES on the disk. 

After you have created a movie you can transfer it to disk 
so that you can use it at a later time. Each M0VIE on has 
a narae that you give it. When you ask for a DISK DIRECT0RY 
you are shown a list of all the names of the M0V1ES that 
are on the disk. 
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f) GRAPH 


e The GRAPH is a 'blow^up' of the FRAME. 

The actual FRAME that you design is located in the upper 
right hand corner of the screen. The PIXELS in the FRAME 
are so small that it would be difficult to design soraething 
using thera. The GRAPH is provided to make design work 
easier. Essentially it is a 'blown up' version of what 
appears in a FRAME. The GRAPH is the array of dots that 
you see on the left side of the screen. Each dot 
represents one PIXEL in the FRAME. Actually, there are two 
kinds of dots: the little ones that you see when you first 

start the program, and the big, fat squares. A little dot 
represents a PIXEL being blank, or OFF. A fat square 
represents a PIXEL being lighted, or ON. 

You've already noticed that there are 24 LINES in the 
GRAPH yet it has been said that a FRAME can have up to 80 
LINES. This inconsistency is explained by stating that the 
GRAPH may display a 24 LINE section of a FRAME at one tirae. 
It can be easily slid up and down, however, to show any 24 
line section. This is almost as good as having a full 80 
(or whatever) LINES displayed on the GRAPH at once. 

g) CURSOR g The CURSOR shows you where you are drawing. 

The CURSOR is like the pencil in the graph paper analogy. 
You can move it about the GRAPH and color in or erase any 
PIXEL just as you would on graph paper. (The cursor has the 
advantage over the pencil in that the eraser never wears 
out!) Instead of looking like a pencil, however, the 
CURSOR is represented by a large box surrounding a PIXEL 

location on the GRAPH. The CURSOR is controlled by the 
joystick. To color or erase a PIXEL, push the joystick 
button. If the PIXEL was OFF before, it will flip ON. If 
it was ON before, it wil flip OFF. 

h) MENU w A MENU in ANIMATOR II is just like a menu in a 

restaraunt. It is a list of things that you may want. To 
do something with ANIMATOR II, you simply choose the 
appropriate selection frora the MENU and the program will 
leap to perform you every wish. (You do not have to tip 
ANIMATOR II as you would a waiter in a restaraunt. After 
using ANIMATOR II long enough you may decide to forever 
give up pencil erasers, and to stop eating out too!) 

i) WINDOW @ The WINDOW is your 'information screen.' 

The WINDOW is the large box surrounding the lower^right 
portion of the screen. ANIMATOR uses the window to show 
you such things as MENUS and DISK DIRECTORIES, and to give 
you instructions pertaining to program operation. 

j) FUNCTION n A FUNCTION is something that you would like ANIMATOR II 

to do• All FUNCTIONS that ANIMATOR II can perform are 
listed in the various MENUS. An example of a FUNCTION 
would be COLOR (as it is listed in the MENU). This 

FUNCTION allows you to change the color of the frame. 

Other functions are similar in that they make ANIMATOR II 

do something. 
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HOW TO DO THINGS 


a) MENU OPERATION M All ANIMATOR II functions are chosen from MENUS* 

There are too many functions to list them all in the 
WINDOW at once so ANIMATOR II offers you many MENUS* Each 
menu contains a list of similar functions* For instance, 
the DISK MODE MENU contains a list of functions all which 
pertain to disk operation. 

MENUS may contain not only FUNCTIONS but also other 
MENUS. The MENUS are organized in a logical fashion so 
that there are MENUS such as the MAIN MENU which mostly is 
a list of other MENUS. These MENUS contain specialized 
FUNCTIONS and also other MENUS which contain even more 
specialized functions and perhaps other MENUS.... 
Eventually, a point is reached where a MENU is so 

specialized that it contains only a list of functions and 
you can then select what you would like to do. The 
generalized MENUS are referred to as the OUTER MENUS while 
the more specialized ones are referred to as the INNER 

MENUS. Therefore, as you move from MENU to MENU you are 
either moving IN or moving OUT. 

When a MENU is displayed in the WINDOW you will see a 
GREEN ARROW pointing at one of the selections. Whenever 
you see the GREEN ARROW it means that ANIMATOR II is 

waiting for you to make a selection. Control which 
selection the GREEN ARROW is pointing at by moving the 
joystick up and down. To choose a selection push the 
joystick button. When the button is pushed, one of two 
things can happen: 

1. If the selection was another MENU, that MENU will 
show in the WINDOW and you will see the GREEN ARROW 
again. 

2. If the selection was a FUNCTION, the GREEN ARROW 
will turn into a VIOLET BOX signifying that a FUNCTION 
is being performed and the FUNCTION will then proceed 
to execute. Some FUNCTIONS may ask you a few 
questions before proceeding. After the FUNCTION is 
finished the MENU will again display in the WINDOW and 
the GREEN ARROW will wait for another selection. 

All MENUS except the MAIN MENU have one selection in 
common. This selection is called BACK. BACK allows you to 
return to the next OUTER MENU. The MAIN MENU doesn't have 
this selection since there is no OUTER MENU. It does, 
however, have END OF PROGRAM. 

In summary, ANIMATOR II provides many MENUS arranged in 
logical order. Each MENU may have a list of FUNCTIONS 
and/or other MENUS. All MENUS allow you to move to the 
next OUTER MENU by selecting BACK. All selections are made 
using the joystick and the GREEN ARROW. 
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b) FUNCTION KEY OPERATION ö Each of the FUNCTION KEYS perforras a 

function. These functions are not listed in the MENUS and these keys 
are only active during the tiraes specified. Pressing thera when they 

are not active will accomplish nothing and will not hurt the program. 

OPTION M Pressing the OPTION key while in the CREATE raode will restore 

the FRAME to its contents when the CREATE mode was entered. 

In other words, it un^does all changes made to that FRAME 
since you started. This is very useful when you are 

experiraenting with changes to a figure and you don't want to 
undraw evrything that you have done. This key is only active 
in the CREATE mode. 

SELECT ŵ Pressing the SELECT key while either in the CREATE raode or 

while the GREEN ARROW is shown in the WINDOW will imraediately 
display the [SELECT] MENU in the WINDOW and the GREEN ARROW 
will wait for you to make a selection. The [SELECT] MENU is 
an extremely useful MENU and you will probably use it quite 
often therefore it is handy to get this MENU by just pushing 
the SELECT button. (This button also has a very special use. 
See explanation given in HINTS.) The SELECT key is active 
only when in the CREATE mode or when the GREEN ARROW is shown 
in the WINDOW• 

START Ä The START key actually has three similar functions: 

1. If you press the START key while the GREEN ARROW is 
waiting for a selection. You will autoraatically be shown the 
next OUTER MENU just as if you had raoved the GREEN ARROW to 
BACK and pressed the joystick button. 

2. If you press the START key while a FUNCTION is asking you 
a question or waiting for you to do something, the FUNCTION 
will abort and you will be returned to the MENU. 

3. Some functions require the START key to be pressed to end 
the FUNCTION. You will be told which functions these are. 
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c) CHOOSING A FRAME B Many times ANIMATOR II will need information 

pertaining to a FRAME and it will tell you to 'CHOOSE FRAME'• 
Use the joystick to do this. Moving the joystick left or 
right will decrement or increment the FRAME NUMBER by one. 
Moving it down or up will decrement or increment by five. 
Pressing the joystick button will select the current FRAME 
NUMBER. Pressing the START button will abort the operation. 

For instance if you are asked to choose a FRAME NUMBER and 
the FRAME NUMBER is currently 10: 

Move the joystick LEFT and the FRAME NUMBER will subtract 

1 giving 9, RIGHT will add 1 giving 11, UP will add 5 giving 
15, and DOWN will subtract 5 giving 5. 

Holding the joystick in the desired direction will cause 
the FRAME NUMBER to continually increraent or decrement 
depending on which direction you are pushing it. This is 
useful for quickly getting from FRAME to FRAME• 

d) CHOOSING a FIRST and a LAST FRAME * Sometimes ANIMATOR II not 

only needs to know just one FRAME but it needs to know a 
group of consecutive FRAMES. Therefore, by choosing a FIRST 
and LAST FRAME you are letting ANIMATOR II know that you mean 
all FRAMES between and including these two. Choose the 
FRAMES in the same raanner as you would a single FRAME. 

A few tricks are available to make the process of choosing 
a FIRST and a LAST FRAME go faster. If you choose the FIRST 
and LAST FRAME to be the same FRAME NUMBER, ANIMATOR II will 
assurae that you raean the FIRST FRAME to be '0' and the LAST 
FRAME to be the last FRAME in the M0VIE. In other words, you 

are specifying the entire M0VIE workspace. 

If you choose the LAST FRAME to be less than the FIRST 
FRAME, ANIMATOR II will assume that you want just the LAST 
FRAME to be the LAST FRAME in the M0VIE. In other words, you 
are specifying the entire MOVIE workspace following the FIRST 
FRAME. You'll find these tricks quite handy sometimes. 

e) CHOOSING a TO and FROM FRAME ŵ ANIMATOR II will sometimes need to 

know just two fraraes. Simply choose each FRAME as you 
normally would. (See COPYing and EXCHANGEing FRAMES.) 

f) CHOOSING a FIRST and a LAST LINE ẅ Some of ANIMATOR IIs FUNCTIONS 

let you do things to partial sections of a FRAME. A section 
is defined as being between and including two LINES. When 
you select a FUNCTION that allows operation on a section of a 
FRAME it will tell you to 'CHOOSE FIRST LINE' and 'CH00SE 
LAST LINE.' When it does this you will see a triangular 
pointer on the left edge of the GRAPH. Move it up or down 
until it is pointing at the LINE that you want to specify. 
Press the joystick button to specify that LINE. Do this 
twice, once for the FIRST LINE, and once for the LAST LINE. 
ANIMATOR II will assume that you mean the section lying 
between and including these two LINES. If you specify both 
LINES to be the same LINE, ANIMATOR II will assume that you 
mean the entire FRAME• Therefore, all you have to do to 
specify the entire FRAME is press the joystick button twice. 
You may abort this operation at any time by pressing the 
START key• 


g) ENTERING A MOVIE NAME All operations may be accomplished in 

ANIMATOR II using just the joystick and the function keys 
with one exception: saving a MOVIE to the disk. ANIMATOR II 
needs to know what name you would like to call the MOVIE. To 
do this just type the name from the keyboard. Legal names 
have the following characteristics: 

1. At least one character and up to eight characters 
long. 

2. Any combination of letters and numbers, but first 
character MUST be a letter. 

Some examples of LEGAL names would be: 

MYMOVIE 

FILE1234 

STUFF 

Q 

Sorae examples of ILLEGAL NAMES would be: 

WHATISTHEMATTERWITHTHIS fl too long 

2SDAY fl starts with a number 

You don't need to worry about typing an illegal name. 
ANIMATOR II won't let you. Thus, the only thing that you 
need to know is: If ANIMATOR II won't let you type it f it's 
illegal. Otherwise, it's legal. 

When typing a name you may use the DELETE key to wipe out 
the last letter typed. Press the RETURN key when you are 
finished. This operation can be aborted by pressing the 
START key• 

h) CONTROLLING BOTH SIDES OF A FRAME fl Although a FRAME may look 

solid, it is actually two pieces. This comes in handy for 

special effects and other things. A FRAME is composed of a 

right and a left side. ANIMATOR II will let you change the 
color, width, or position of each side. When using the 
functions that let you change these parameters, a way is 
provided to let you easily and quickly specify which side you 
want to work on. When the joystick button is not depressed, 
you will have control of the right side. If you press and 
hold the button, you will have control of the left side. 

Abort the operation by pressing the START key. 

For example, if you want to change the color of the FRAME 
you would first choose the COLOR function using the menu. 
ANIMATOR II would then wait for you to change the color of 
the FRAME using the joystick. If you moved the joystick 
around without pushing the button the color would change on 
the right side of the FRAME• If you held the button down, 
the color would change on the left side. When you had 
achieved the desired color combination press the START key 
and the operation would be complete. This is also true for 
the WIDTH and POSITION functions. This is not meant to be a 
description of how to change color but rather an explanation 
of how to specify each side. For a more detailed description 
on color and the other functions, see their appropriate 
explanations• 
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i) USE OF THE PADDLES & If you have paddle controllers they should 

be plugged into port #2 of your computer. For this program 
you raight want to label them paddle #1 and paddle #2 with a 
s ticker or soraething since each has a unique use* Trace the 
cord coming out of the left side of the paddle plug* This 
will be referred to as paddle # 1 • The other one (obviously) 
is paddle #2. 

Paddle #1 is used in the ROLL FILM and the ANIMATE 
functions to control frame speed. By twisting it completely 
clockwise you can obtain aniraation speeds of up to 200 frames 
per second. Twisting it all the way counter Q clockwise will 
slow animation down to about 1 frarae per second. 

Paddle #2 is used in the ANIMATE function only to control 
the sensitivity of the joystick. If turned completely 
clockwise, your figure will zoom around the screen with the 
speed of a quick g 1izzard with its tail on fire* At the other 
extreme, if you turn it corapletely counter a clockwise you 
figure will raove around the screen at a speed comparable to 
that of a growing stalagtite. (Well, not quite....but 

almost!) Any positions between these these two extreraese 
will give speeds that vary proportionally. 

j) CH00SING A M0VIE FROM THE DIRECTORY ft With most of the options 

using the disk drive you will be required to choose a M0VIE 
from the disk for some reason or another. An easy way has 
been provided to do this. When you choose such an FUNCTION, 
all the M0VIES on the disk will begin to display in the 
WINDOW one at a time. An arrow will point to the M0VIE that 

it is currently asking about. If this is the M0VIE that you 
want, simply press the joystick button and the FUNCTION you 
selected will be perforraed with that M0VIE* If it is not the 
M0VIE you want, tap the joystick backwards just a bit and a 
new M0VIE will be brought up on screen with an arrow pointing 
at it« This will continue until you have either selected a 
M0VIE or all the M0VIES on the disk have been listed. At any 
point you can press the START key and be returned to the 
menu • 

k) HOW T0 DRAW ON THE GRAPH When you select the CREATE FUNCTION 

you are allowed to draw things on the GRAPH. Move the CURSOR 
by pushing the joystick in the appropriate direction, Turn 
PIXELS ON or OFF by pressing the joystick button. You can 
draw lines in any direction by holding down the joystick 
button while you push the joysticfc. If you move the CURSOR 
off the left edge it will appear on the sarae line on the 
right edge. The reverse operation is also true. 

You can choose which 24 ft LINE section of a FRAME that you 
are viewwing by pushing the CURSOR against either the top of 
the bottom edge of the GRAPH. All PIXEL changes that you 
make on the GRAPH will iramediately appear in the FRAME. 
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PROGRAM FUNCTIONS AND OPERATION 

Following is an explanation of each FUNCTION or MENU in ANIMATOR II 
and its operation. They are listed in in the order in which they 
appear in the MENU. 


MAIN MENU SELECTIONS: 

DISK MODE ŵ This is a MENU which contains all functions that relate 

to using the disk drive. 

DESIGN MODE e This is a MENU. It contains most of the functions 

relating to program and is the actual heart of the program. 
All design work is done within this MENU. 

ROLL FILM u This is a function that allows you to see any portion 

of your movie at a speed you control. 

CHOOSE FIRST FRAME. CHOOSE LAST FRAME• 

Control the speed of animation using paddle #1. 

The film will keep cycling until you abort by pressing the 
START key• 

ANIMATE! # This is the show^off function of the program and you'll 

certainly agree that it deserves that exclamation point. You 
are allowed to see any portion of your movie at a speed you 
control and you can simultaneously move your creation all 
around the screen using the joystick. Just imagine, you can 
make a movie of a dog or cat and then take it for a walk 
around the screen. 

CHOOSE FIRST FRAME• CHOOSE LAST FRAME• 

Control the speed of aniraation using paddle #1. 

Control the sensitivity of the joystick using paddle #2. 

Grab the joystick and raove your creation ALL OVER the screen. 
FUN, ISN'T IT? 

Again, the film will keep cycling until you press the START 
key to abort. 

END OF PROGRAM ^ This is a MENU with only one choice, that of 

quitting the program. The reason that it is a MENU instead 
of a function is so that you have a chance of returning to 
the MAIN MENU in case you accidently choose this selection 
when you really don't want to quit. 


* 




a 
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DISK MODE 


LOAD FILM „ This is a function that lets you bring a MOVIE from 

disk into memory. 

CHOOSE A MOVIE FROM THE DIRECTORY. 

CHOOSE FIRST FRAME. CHOOSE LAST FRAME. 

The MOVIE will then be brought into memory beginning at the 
FIRST FRAME. Any FRAMES that would fall after the LAST FRAME 
will be cut. 

SAVE FILM ju This function allows you to save any movie in memory to 

a floppy disk. 

CHOOSE FIRST FRAME. CHOOSE LAST FRAME. 

ENTER NAME 

All FRAMES between and including the FIRST and LAST FRAME 
will be put to disk using the name that you typed frora the 
keyboard. 

DISK DIRECTORY „ This allows you to see what MOVIES are on the disk. 

Hold the joystick back so that they will continually appear 
in the WINDOW. Pressing the joystick button aborts the 
o pera tion. 

LOCK FILM 8 This allows you to protect a movie on disk so that you 

cannot accidentally erase it. All 'loched' MOVIES wilí show 
up on the D1SK DIRECTORY with an 'X' in front of them. 

CHOOSE A MOVIE FROM THE DIRECTORY 
This MOVIE will be LOCKED. 

UNLOCR „ This is the opposite of 'loching' a MOVIE. It removes 

the protection given to it by using LOCK. 

CHOOSE A MOVIE FROM THE DIRECTORY 
This MOVIE will be UNLOCRED. 

DELETE FILM 8 This allows you to remove a MOVIE from disk. You 

cannot DELETE a MOVIE that has been locked. 

CHOOSE A MOVIE FROM THE DIRECTORY 
This MOVIE will be DELETED. 
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DESIGN MODE 


ENVIRONMENT ö This is a MENU. Within this MENU you can change all 

environmental parameters of a frame such as COLOR, POSITION, 
WIDTH, or PIXEL HEIGHT• 

EDIT FILM This is a MENU. Within this MENU are all functions 

relating to changing the sequence or content of your MOVIE. 
You may rearrange you MOVIE on a FRAME by FRAME basis. 

CREATE ö This is the actual center of ANIMATOR II. Using this 

FUNCTION you draw your figures. All function keys are active 
when you use CREATE. (See HOW TO DRAW, FUNCTION KEY 
OPERATION, and HINTS) 

[SELECT] ŵ This is the same MENU that you will receive if you push 

the SELECT button. It has a collection of the most often 
used functions in this prograra. 

SCAN FILM g This is a function that just lets you take a look at what 

you have in your MOVIE. It is also used to select which 
FRAME you would like to work on. It works exactly like 
choosing a FRAME. Press the joystick button or START to 
abort. (Note that this FUNCTION appears in most MENUS. This 
is because it is useful in quite a few different 
applications. ) 

CHOOSE FRAME 


II 
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ENYIRONMENT MENU 


WIDTH w This will let you control the width of the PIXELS on either 

or both halves of the FRAME• PIXELS can be normal, double, 
or quadruple width. Using the button to select which half to 
change, move the joystick left or right to change widths, 

Press START to abort the function. You may want to use the 
POSITION function after using WIDTH. 

HEIGHT Ä If you have selected a FRAME height that is less than 41 

PIXELS this function will let you make the PIXELS either 
double or single height. Push the joystick forward to switch 
to double height. Pull the joystick back to shrink it to 
single height. Press the START button to abort the function. 
Note that in double height the PIXELS seera blocky and square 

while in single height they are rectangular. You cannot 
specify double height or single height for individual halves 
of a FRAME. 

COLOR u This function allows you to change the color or shade of 

either half of the FRAME• Using the joystick button to 
select which half, move the stick left or right to control 
color. Move the stick up and down to control shade. Note 
that the name of the color you are using will appear in the 
bottom*left corner of the window. This is useful if you have 
a blacK and white television and you would like to see what 
color combinations work well* All color names are a six 
letter abbreviation. Each half is capable of displaying any 

of 16 colors and 8 shades giving you 16384 possible color 
combinations• Press the START key to abort this function. 

POSITION n This function lets you change the position of each half 

of the FRAME in relation to the other half. Using the 
joystick button to select which half, move the stick left or 
right to slide the half to the desired position. Press the 
START key to abort. 

SCAN FILM ^ (See SCAN FILM in DESIGN MODE MENU) 
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EDIT FILM MENU 


INSERT # This function allows you to insert a blank FRAME anywhere in 

the film* This is useful if you would like to provide 
additional animation in between FRAMES. 

CHOOSE FRAME 

This FRAME and all FRAMES following it will be 'scooted' up 
by 1 FRAME number. The last FRAME in the MOVIE will be lost. 

DELETE B This function allows you to delete a FRAME anywhere in the 

film. This is useful for removing unwanted FRAMES frora a 
MOV1E• 

CHOOSE FRAME 

This FRAME will be lost. All FRAMES following it will be 
'scooted' down 1 FRAME number to fill the vacancy. The last 
FRAME in the MOVIE will become blank. 

EXCHANGE g This function allows you to exchange any two FRAMES in 

a MOVIE• 

CHOOSE 'FROM' FRAME• CHOOSE 'TO' FRAME• 

These two FRAMES will swap positions, 

COPY # This function allows you to copy any FRAME to any 

other FRAME. It is useful for duplicating a FRAME quickly. 
CHOOSE 'FROM' FRAME• CHOOSE 'TO' FRAME• 

The 'TO' FRAME will become identical to the 'FROM' FRAME. 

CLEAR Ä This function allows to clear out any consecutive group of 

FRAMES• It is different from the DELETE function in that it 
does not move any FRAMES down to fill the empty FRAMES, it 
simply wipes them clean. 

CHOOSE FIRST FRAME• CHOOSE LAST FRAME• 

All FRAMES in between and including the FIRST and LAST FRAME 
will be cleared. 

SCAN FILM # (See explanation in DESIGN MODE MENU) 
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[SELECT] MENU 

NEXT (WITH COPY) 0 This function copies the current FRAME to the 

following FRAME and raakes that the current FRAME* This 
function is useful because it elirainates the task of 
redrawing a figure frora scratch every time you raove on to the 
next FRAME* You only have to worry about making changes to a 
figure instead of doing redundant work* 

CHOOSE FIRST LINE• CHOOSE LAST LINE. 

The section in between and including these two lines will be 
copied to the next FRAME. Copying be section is useful 
because it allows you to do you animation a little bit at a 
time. For exaraple if you are raaking a walking raan, you first 
raake the walking legs copying only that section to the next 
FRAMES, then you do the body and swinging arras, copying only 
that section (without interfering with the leg aniraation) and 
s o o n • • • 

NEXT (NO COPY) ^ This function simply increments the current FRAME 

nuraber without making any changes to FRAMES. This is useful 
when you need to go back and do individual 'touch up' work to 
each FRAME• 

FILL ^ This function allows you to fill any section of a FRAME 

with ON PIXELS• 

CHOOSE FIRST LINE• CHOOSE LAST LINE • 

All dots between and including these two lines will be filled 
with dots. 

SHIFT ŵ This function allows you shift any section of a FRAME in any 

direction. This is useful for quickly moving figures around 
the FRAME without having to completely redraw thera in a 

different location. 

CHOOSE FIRST LINE. CHOOSE LAST LINE • 

Push the joystick in the desired direction. The section that 
you chose will shift accordingly. Note that all edges will 
shift onto the opposite edge so that no portion of the 
section is lost• Continue raoving the joystick until you are 

satisfied. Press the START key to abort. 

INVERSE 0 This function allows you to invert any section of a FRAME. 

In other words it turns all ON dots OFF, and turns all OFF 
dots ON. 

CHOOSE FIRST LINE• CHOOSE LAST LINE • 

The section between and including these lines will be 
inverted. 
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[ SELECT MENU] 


• •♦.(continued) 


CLEAR ^ This function allows you clear any section of a FRAME* 

It saves you the task of going around and wiping out 
individual dots. 

CHOOSE FIRST LINE. CHOOSE LAST LINE. 

The section between and including these lines wil be cleared. 

MERGE This is a MENU that has selections associated with merging. 

MIRROR R This is a function that allows you to rairror any section 

of a FRAME. This is useful for such things as raaking walking 
men face the other direction without having to completely 
redraw them. 

CHOOSE FIRST LINE• CHOOSE LAST LINE • 

Move the joystick up or down to rairror in an up/down fashion. 
Move the joystick left or right to mirror left/right. Press 
START to abort. 


SCAN FILM 


(See explanation in DESIGN MODE MENU) 



MERGE MENU 


This MENU allows you to specify in what way you would like to inerge 
two FRAMES together. To merge two FRAMES, complete the following 
s teps: 

1. Select the desired merge type by moving the GREEN ARROW to 
the approriate selection and pressing the button. 

2. Select the DO MERGE function. 


When two frames are merged together ANIMATOR II goes through each 
FRAME, PIXEL by PIXEL, and compares corresponding PIXEL locations. It 
then combines them together in a specified manner to form a new FRAME. 
By choosing a merge type you are telling ANIMATOR II the conditions 
for merging the two FRAMES. The best way to find out what each of 
these merge types does is to experiment. You will probably find (OR) 
the raost useful. 


(AND) a If the first PIXEL 'AND' the second PIXEL are both ON, the 


resulting PIXEL will be ON. 

PIXEL #1 PIXEL #2 RESULT 

off off off 

o f f on o f f 

on of f of f 

on on on 


( OR) 


If either the first PIXEL 'OR' the second PIXEL is ON, the 

B 


resulting PIXEL will be ON. 

PIXEL #1 PIXEL #2 RESULT 

off off off 

off on on 

on off on 

on on on 


(XOR) * This is an abbreviation for EXLUSIVE Ẅ OR. If either the first 

PIXEL 'OR' the second PIXEL is ON, BUT NOT BOTH, the 


resulting PIXEL will be ON. 

PIXEL #1 PIXEL #2 RESULT 

off off off 

off on on 

o n o f f on 

on on of f 


DO MERGE ŵ This function allov/s you to merge two FRAMES together to 

obtain a new FRAME• Be sure you specify the type of raerge you 
want before you use this function or you may obtain different 
results from what you would expect. 

CHOOSE FIRST LINE 
CHOOSE LAST LINE 
CHOOSE FRAME 

The section between and including the specified lines will 
be merged with the corresponding section in the FRAME 
specified. You may press START at any time and abort. 
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END OF PROGRAM MENU 


QUIT! 


BACK „ 


> 


N You are absolutely sure that you want to quit. The screen 

will clear and the coraputer will drop into the MEMO PAD MODE. 
Press the RESET key to re^boot the disk drive. This will 
wipe out anything you have done so be sure you save any 
MOVIES that you want before you QUIT. 

You accidentally selected this MENU and so you want to return 
to the MAIN MENU without doing any daraage. Consider this 
your 'second chance.' 


•a 
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EXAMPLES & HINTS ON HOW TO EFFECTIVELY USE ANIMATOR II 

a) HOW TO USE THE MOVIES PROVIDED WITH ANIMATOR II 

1. Start the ANIMATOR II prograra as shown in GETTING STARTED. 

2. Select a height of 40 PIXELS. ANIMATOR II will load into 

meraory• 

3. Select DISK MODE from the MAIN MENU• 

4. Select LOAD FILM from the DISK MENU• 

5. Choose any M0VIE from the disk directory, 

6* When asked for FIRST and LAST FRAMES, simply push the 

joystick button twice since you want to use the whole MOVIE 
if necessary. The film will load into memory, Note the last 
FRAME used by the film when it comes in, 

7. Select BACK so that you will return to the MAIN MENU. 

8. Select ROLL FILM or ANIMATE! since you want to play with the 

f ilm. 

9. Choose FIRST and LAST FRAMES making sure that the LAST FRAME 

was the last FRAME brought in from disk. 

10. YOU'RE ALL SET! Use the paddles and/or joystick to play 
around to your hearts content. You may want to slow the FRAME 
speed way down so that you can see just how the animation is 
accomplished. 

11. Press the START button to stop. You may load another M0VIE 
if you want to by following the steps starting with step #3. 

b) SOME HINTS ON HOW TO CREATE ANIMATION QUICKLY 

1. Draw figures a bit at a time. For example, if you are 
making a walking man you would first do the moving legs, 

then go back and do the swinging arms and waving body, then 
go back and do the bobbing head and rolling eyes, and, if 
he's a matian, go backand do the spinning thorples on his 
head. In this way you are not faced with a whole bunch of 
complicated motions to worry about at once. You can 
concentrate on just one action at a time. 

2. Use the NEXT (WITH COPY) function to its fullest extent. 
When you have finished drawing a FRAME follow the 
following procedure: 

a) Press SELECT. The SELECT MENU will appear in the window. 

b) Press the joystick button (since the GREEN ARROW is 
already pointing at NEXT (WITH COPY)). 

c) Copy the appropriate sections to the next FRAME. 

d) Move the GREEN ARROW to BACK and press the joystick 
button. You will be returned to the DESIGN MODE MENU. 

e) Press the joystick button (since it is already pointing at 
CREATE) 

f) Draw the next FRAME. 

Although this may seem complicated at first, with practice 
this entire sequence can be perforraed in a few seconds. 

3. If you press the SELECT key while the CURSOR is on the left 
edge of the GRAPH, a NEXT (WITH COPY) will occur for the 
entire FREAME. Be sure not to do this accidentally• 
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4 


Don't be meticulous when drawing an animation sequence. 

Draw a close, but quick, approximation of what you want. 

The go back and use the NEXT (NO COPY) function to touch up 
your work, 

5* Make animation scenes 'cyclic'* Do this in order that 

when they are played over and over again you will not be able 
to tell what the first and tlie last FRAME is since the raotion 
will be sraooth. This is difficult since you have to 
synchronize all movements with each other but it raakes 
aniraation much more enjoyable when using the ANIMATE! or 
ROLL FILM functions. See the raovies provided with 
ANIMATOR II for examples of how this is done. 

6. Learn to think ahead so that you will know what raoveraents 
you need later so that you will not have to do extensive 
reworking of your MOVIES. 

7. Using these hints (and some you come up with on your own) 
you will be able to create quick and lively MOVIES in short 
periods of time* (Soraetimes in less than 15 minutes!) 


* 
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TECHNI'CAL NOTES (for advanced users) 

You can use ANIMATOR II MOVIES in your own prograras and games. It 
is very easy to read ANIMATOR FILES. 

All ANIMATOR II files have a .FRM suffix. 

a) FILE FORMAT: 

## „ Input #1; NUMFRAMES „ number of FRAMES in the file 

## n Input y/l;HEIGHT # nuraber of pixels per FRAME 

STRINGyg Input #1;BUFFER$ 

STRING 


a 


s 




Each string is twice as raany bytes long as the FRAME is high and 
represents one FRAME* 

For exaraple, if the FRAME height was 40 pixels, each string would 
be 80 bytes long. The first 40 bytes would be for the left half of 
the FRAME, the second 40 would be for the right half. 

Here is a short BASIC program to read in such a files 


10 DIM FRAME$(10000),BUFFER$(160) 
20 OPEN //l,4,0, ,, MEEP.FRM n 

30 INPUT #1;NUMFRAMES 
40 INPUT #1;HEIGHT 
50 FOR X=1 TO NUMFRAMES 
60 INPUT #1;BUFFER$ 


tì 10000 IS ARBITRARY 
tì OPEN FILE FOR INPUT 

INPUT THE NUMBER OF FRAMES 
fl INPUT PIXEL HEIGHT 
fl LOOP T0 INPUT ALL FRAMES 


70 FRAME$((X fl 1)*HEIGHT*2+1,(X fl 1)*HEIGHT*2+HEIGHT*2)=BUFFER$ 
80 NEXT X 


90 CLOSE #1 

100 ... 


The first 40 bytes of FRAME$ would be the left side of FRAME #0. 
The second 40 bytes would be the right half of FRAME #0. 

The next 40 bytes would be the left half of FRAME #1. 

And so on. 


b) HOW THE ANIMATION IS DONE 

Of course, it's done with player/raissle graphics. If you are not 
familiar with player/raissle graphics, there's plenty of good reading 
around. For those of you who do, each FRAME in ANIMATOR II is simply 
two players side by side. That is why the FRAMES are read in from 
disk in sections of two. No further explanation of player/missle 
graphics will be given here. 

To create animation, all you have to do is put both sides of the 
FRAME in the player/missle area. This is best done using raachine 
language but it is possible to get speeds of up to 8 FRAMES per second 
using BASIC. What is needed is a short copy routine (in machine 
language) that will copy any section of raeraory to any other section of 
memory. You then create a loop in BASIC that will call this routine 
twice, once for each half of the FRAME, that copies the appropriate 
FRAMES into the player raissle area. The aniraation at the start of 
ANIMATOR II is done in this fashion. 
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ERROR MESSAGES 


Although you raust try very hard, it is possible to create sorae 
probleras for ANIMATOR II* When you do this, ANIMATOR II will sound a 
short warning signal and type the error message in the window so that 
you will know what you did wrong. Here is a list of error raessages 
and what they mean* 

DISK IS FULL ẅ There is no raore roora on your floppy disk for MOVIES* 
Either delete some MOVIES using the DELETE option or use another 
floppy disk that has more roora. 

DIRECTORY IS FULL ŵ There is only room on a disk for up to 64 MOVIES, 
no raatter how long or short they are* Follow the sarae procedure that 
you would for DISK IS FULL. 

ILLEGAL CHARACTER ë You 'accidentally' pushed control^S while entering 
in the narae of the MOVIE to save to disk* Don't do it again* 

CAN'T FIND FILE ŵ The MOVIE you specified is not on the disk that is 
currently in the drive* This raessage is only possible if you switch 
disks before ANIMATOR II has a chance to load the MOVIE. Don't do 
t his • 

DISK WON'T ANSWER Ä Either your disk drive is turned off or a 
connection is loose. Check to make sure all cables are plugged in 
snuggly. 

DISK IS PROTECTED You can get this error when you try any of the 
DISK MODE MENU options. (except LOAD MOVIE) This disk has a 
write^protect sticker on 
the notch. 

FILE LOCKED * You have tried to DELETE a MOVIE that has been LOCKED. 

If you really want to DELETE it you raust first UNLOCK it. 

** NEW ERROR ** ^ This raeans that youWe discovered a totally new 
error, an error that no^one has even seen before. Congratulate 
yourself and then go look up the error nuraber on the inside front 
cover of the BASIC REFERENCE MANUAL to see what you did. 



ta 


FUTURE USES 


The things that you can accoraplish with ANIMATOR II are almost 

unlimited but here are a list of things that you might want to try 
5 d o i n g • 

a) Overlap the two sides of the FRAME to create a multi^colored 
figure* Depending on how you do it, you could be limited as far as 
the width of the FRAME but in some cases, the extra color might be 
worth it. 

b) Make exotic designs that don't look like anything at all but that 
swirl and change and twist and bend. Make something that is 
absolutely HYPNOTIZING! 

AND IF YOU'RE A FAIRLY GOOD PROGRAMMER: 

c) Put some action in your garaes. Really LIVEN them up. Now it's 
easy. The possiblities are endless. 

d) Put aniraation to sound. Make a dancing snake, a waltzing bear, a 
pianist playing the piano, anything!!!! 

e) Make a garae for little kids so they could each control a little 
figure and run it all around the screen. This kind of program would 
be EXTREMELY popular. 

f) ABOVE ALL.USE YOUR IMAGINATION!! 


0 


1 


ì 


ä 


* 




Page 24 




MENU LAYOUT 


MAIN MENU 

DISK MODE 

Load film 
Save film 
Disk Directory 
Lock film 
Unlock film 
Delete film 
BACK 

DESIGN MODE 

ENVIRONMENT 

Width 

Height 

Color 

Position 

Scan Film 

BACK 

EDIT FILM 


B Loads a MOVIE in from disk 
B Saves a MOVIE to disk 
^Lists all MOVIES on the disk 
a Protects a MOVIE against deletion 
# Removes protection from MOVIE 
^Deletes a MOVIE if it isn't locked 
(TO MAIN MENU) 


a Set width of fame pixels 

Ä Set height of FRAME pixels 

ŵ Set color of FRAME pixels 

a Set position of either FRAME half 

fi Lets you scan the MOVIE 

(TO DESIGN MODE MENU) 


Insert 

Dele te 

Exchange 

Copy 

Clear 

Scan Film 

BACK 

Create 
[SELECT] 

Next (with copy) 

Next (no copy) 

Fill 

Shif t 

Inverse 

Clear 

MERGE 

( AND ) 

( OR ) 

( XOR ) 

DO MERGE 
B ACK 

Mirro r 
Scan Film 
BACK 

Scan Film 
BACK 

Roll Film 
Animate! 

END 0F PROGRAM 

QUIT ! 

B ACK 


B Inserts a blank FRAME in MOVIE 

È Delete a FRAME in MOVIE 

0 Exchanges two FRAMES 

ŵ Copies one FRAME onto another 

^Clears group of consecutive FRAMES 

ft Lets you scan the MOVIE 

(TO DESIGN MODE MENU) 

tf Lets you design using the GRAPH 

0 Copies current FRAME to next FRAME 

ẅ Increraents FRAME 

^Fills any section of a FRAME 

ŵ Lets you shift any section of a FRAME 

e Inverts any section of a FRAME 

a Clears any section of a FRAME 

0 Sets type of merge as AND 
fl Sets type of merge as OR 
a Sets type of merge as EXCLUSIVE OR 
tí Merges two FRAMES together 
(TO [SELECT] MENU) 

^Mirrors any section of a FRAME 
a Lets you scan the MOVIE 
(TO DESIGN MODE MENU) 
a Lets you scan the MOVIE 
(TO MAIN MENU) 
a Plays MOVIE 

tì Plays MOVIE, Control with joystick 

a Absolutely quits the prograra 
( TO MAIN MENU) 



